Adds a keychain item to the default keychain.

OSStatus KCAddItem (
    KCItemRef item
);

item

A reference to the keychain item you wish to add. If you pass an existing item in the keychain, the item is updated. If you pass an item that has not been previously added to the keychain and an identical item already exists in the keychain, KCAddItem returns the result code errKCDuplicateItem.

function result

A result code. The result code errKCNoDefaultKeychain indicates that no default keychain could be found. The result code errKCInvalidItemRef indicates that the specified keychain item reference was invalid. The result code errKCDuplicateItem indicates that you tried to add a new item that already exists in the keychain.

DISCUSSION

You can use the KCAddItem function to add a keychain item to the permanent data store of the default keychain. If you want to add an item to a specific keychain, bracket this call with the functions KCGetDefaultKeychain and KCSetDefaultKeychain. KCAddItem may display the Unlock Keychain dialog box if the keychain containing the item is currently locked.

VERSION NOTES

Available beginning with Keychain Manager 1.0.

AVAILABILITY

Under evaluation for Carbon. Available in CarbonLib 1.0 and later when KeychainLib 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by KeychainLib 1.0 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)